// Copyright (c) 2017-2024, Mudita Sp. z.o.o. All rights reserved.
// For licensing, see https://github.com/mudita/MuditaOS/blob/master/LICENSE.md

/*
** ###################################################################
**     Processors:          MIMXRT1051CVJ5B
**                          MIMXRT1051CVL5B
**                          MIMXRT1051DVJ6B
**                          MIMXRT1051DVL6B
**
**     Compilers:           Freescale C/C++ for Embedded ARM
**                          GNU C Compiler
**                          IAR ANSI C/C++ Compiler for ARM
**                          Keil ARM C/C++ Compiler
**                          MCUXpresso Compiler
**
**     Reference manual:    IMXRT1050RM Rev.5, 07/2021 | IMXRT1050SRM Rev.2
**     Version:             rev. 1.4, 2021-08-10
**     Build:               b210811
**
**     Abstract:
**         Provides a system configuration function and a global variable that
**         contains the system frequency. It configures the device and initializes
**         the oscillator (PLL) that is part of the microcontroller device.
**
**     Copyright 2016 Freescale Semiconductor, Inc.
**     Copyright 2016-2021 NXP
**     All rights reserved.
**
**     SPDX-License-Identifier: BSD-3-Clause
**
**     http:                 www.nxp.com
**     mail:                 support@nxp.com
**
**     Revisions:
**     - rev. 0.1 (2017-01-10)
**         Initial version.
**     - rev. 1.0 (2018-09-21)
**         Update interrupt vector table and dma request source.
**         Update register BEE_ADDR_OFFSET1's bitfield name to ADDR_OFFSET1.
**         Split GPIO_COMBINED_IRQS to GPIO_COMBINED_LOW_IRQS and GPIO_COMBINED_HIGH_IRQS.
**     - rev. 1.1 (2018-11-16)
**         Update header files to align with IMXRT1050RM Rev.1.
**     - rev. 1.2 (2018-11-27)
**         Update header files to align with IMXRT1050RM Rev.2.1.
**     - rev. 1.3 (2019-04-29)
**         Add SET/CLR/TOG register group to register CTRL, STAT, CHANNELCTRL, CH0STAT, CH0OPTS, CH1STAT, CH1OPTS,
*CH2STAT, CH2OPTS, CH3STAT, CH3OPTS of DCP module.
**     - rev. 1.4 (2021-08-10)
**         Update header files to align with IMXRT1050RM Rev.5.
**
** ###################################################################
*/

/*!
 * @file MIMXRT1051
 * @version 1.4
 * @date 2021-08-10
 * @brief Device specific configuration file for MIMXRT1051 (header file)
 *
 * Provides a system configuration function and a global variable that contains
 * the system frequency. It configures the device and initializes the oscillator
 * (PLL) that is part of the microcontroller device.
 */

#ifndef _SYSTEM_MIMXRT1051_H_
#define _SYSTEM_MIMXRT1051_H_ /**< Symbol preventing repeated inclusion */

#ifdef __cplusplus
extern "C"
{
#endif

#include <stdint.h>

#ifndef DISABLE_WDOG
#define DISABLE_WDOG 1
#endif

    /* Define clock source values */

#define CPU_XTAL_CLK_HZ 24000000UL /* Value of the external crystal or oscillator clock frequency in Hz */

#define CPU_CLK1_HZ 0UL /* Value of the CLK1 (select the CLK1_N/CLK1_P as source) frequency in Hz */
    /* If CLOCK1_P,CLOCK1_N is choose as the pll bypass clock source, please implement the CLKPN_FREQ define, otherwise
     * 0 will be returned. */

#define DEFAULT_SYSTEM_CLOCK 528000000UL /* Default System clock value */

    /**
     * @brief System clock frequency (core clock)
     *
     * The system clock frequency supplied to the SysTick timer and the processor
     * core clock. This variable can be used by the user application to setup the
     * SysTick timer or configure other parameters. It may also be used by debugger to
     * query the frequency of the debug timer or configure the trace clock speed
     * SystemCoreClock is initialized with a correct predefined value.
     */
    extern uint32_t SystemCoreClock;

    /**
     * @brief Setup the microcontroller system.
     *
     * Typically this function configures the oscillator (PLL) that is part of the
     * microcontroller device. For systems with variable clock speed it also updates
     * the variable SystemCoreClock. SystemInit is called from startup_device file.
     */
    void SystemInit(void);

    /**
     * @brief Updates the SystemCoreClock variable.
     *
     * It must be called whenever the core clock is changed during program
     * execution. SystemCoreClockUpdate() evaluates the clock register settings and calculates
     * the current core clock.
     */
    void SystemCoreClockUpdate(void);

    /**
     * @brief SystemInit function hook.
     *
     * This weak function allows to call specific initialization code during the
     * SystemInit() execution.This can be used when an application specific code needs
     * to be called as close to the reset entry as possible (for example the Multicore
     * Manager MCMGR_EarlyInit() function call).
     * NOTE: No global r/w variables can be used in this hook function because the
     * initialization of these variables happens after this function.
     */
    void SystemInitHook(void);

#ifdef __cplusplus
}
#endif

#endif /* _SYSTEM_MIMXRT1051_H_ */
